# Agora Editor

- To contribute to the [[Agora]], you need to write down notes or posts in one of the [[supported formats]] and upload your notes to a ***git repository*** of your choice. These steps are expanded below.
  - Get a [[github]] account if you don't have a git host already: <https://github.com>.
    - Install [[git]] if needed: <https://git-scm.com/download>. It should be installed by default in [[linux]], comes bundled with [[mac os]].
  - See [[agora signup]] for more details on the process.
- In a nutshell: you need to host your notes (more generally, [[resources]], defaulting to [[markdown]] plus [[wikilinks]]), somewhere online. And then let the [[agora]] know about it.
	- The Agora doesn't host your data, but rather pulls it from a location *you* control and renders it for you and other users; in the process interlinking your data with that of other users.
	- Most users currently host [[git]] repositories on https://github.com or https://gitlab.com. 
	- Note using the default format (Markdown) lets you also easily publish your [[blog]] or [[digital garden]] independently online with tools such as [[jekyll]], [[gatsby]] or [[nikola]].
- As of [[2021-05-07]], the recommended Agora editor is:
	- [[foam]], if you want open source hosted locally.
		- [[foam]] is a [[vscode]] [[extension]].
		- [[foam]] is less straightforward to set up than the next options.
	- [[logseq]], if you want open source, value the convenience of a hosted setup, *and* use [[chrome]] or a [[chromium based browser]] (any browser but [[firefox]], essentially).
	- [[obsidian]] if you don't mind using closed software from a small ethical company, in particular a small one with a vibrant open source extension community. 
		- You need at least also the [[obsidian git]] plugin.  See [[obsidian plugins]] for more.
		- [[install obsidian]] by visiting https://obsidian.md and then follow [[vault backup]] to set up backup to [[git]]: https://docs.github.com/en/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line.
		- Then follow the procedure below to add your vault or [[digital garden]] to the [[agora]].
	- You can also use:
	  - [[dendron]], which should be a drop-in [[foam]] replacement in [[vscode]].
	  - [[roam]] plus [[roam2agora]]
	  - [[org mode]]
	  - (In essence, all you really need to use the [[Agora]] is the capability to produce text in some format and make it publicly available somewhere. Plain text would suffice.)
- After getting yourself a [[repository]], you need to let an [[agora]] know about it so it can be pulled and integrated. 
	- Please send a [[pr]] adding your garden to [[gardens yaml]], accepting the agora's [[contract]] and indicating your desired username; or reach out to signup@anagora.org, [[flancian]] or [[vera]] with information about your use case. We'll do our best to make it work! We want the [[agora]] to be maximally inclusive.
	- All [[agora]] users must agree to its [[contract]] as defined by the system account. 
		- The contracts of other users can optionally be a [[endorsed]].
- My proposal to you now is that we use the capability of sharing and discovering context-relevant media at effectively zero cost for the greater good: let's agree on a protocol to escape [[vendor lock-in]] and cooperate optimally on projects of [[public utility]].
	- [[agora protocol]]